home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / accs / minilist / minilist.doc < prev    next >
Encoding:
Text File  |  1986-02-05  |  15.0 KB  |  300 lines
  1. ----------------------------------------------------------------------------           
  2.                  Bedienungsanleitung zum Programm MINILIST
  3.                 Version 3.6 vom 05.12.1989 von Thomas Broich
  4.                      geschrieben in C auf dem Atari ST
  5.                  entwickelt von Dezember'88 bis Dezember'89
  6.              
  7.           - das Programm zum Anzeigen und Drucken von Textdateien -
  8.        
  9. ----------------------------------------------------------------------------
  10.  
  11. Hier die Eigenschaften des Programms in Kürze:
  12.  
  13.  
  14. - Laden einer beliebigen Textdatei von Diskette
  15. - Anzeigen der Datei auf dem Bildschirm (1-spaltig oder 2-spaltig in Schmal-
  16.   schrift)
  17. - vor- und rückwärts blättern
  18. - erste Seite / letzte Seite
  19. - beliebige Seitenwahl
  20. - Strings suchen
  21. - Klemmbrettfunktion ( ab Version 2.7 )
  22. - optimaler Ausdruck auf dem Drucker bezüglich Blattausfüllung
  23.   ( 4 verschiedene Schriftgrößen zur Auswahl )
  24. - Einzelblatt- und Endlospapierverarbeitung (letzteres berücksichtigt auto-
  25.   matisch Perforation)
  26. - editierbare Datei für Druckersteuercodes
  27. - frei bestimmbare Zeichenkonvertierung (Atarizeichen -> Druckerzeichen)
  28. - Seitennummerierung
  29. - Info Box informiert über Anzahl benötigter Seiten für den Ausdruck
  30. - über Tastatur fast ohne Maus steuerbar (daher schnell zu bedienen)
  31. - Hilfsfunktion zeigt bei Bedarf alle verwendeten Tasten und ihre Funktionen
  32. - lauffähig auf allen ST Modellen nur in hoher Auflösung (SM124)
  33. - überall dort zu gebrauchen wo schnell aus dem Desktop heraus Texte ange-
  34.   sehen werden müssen oder Dateien (papiersparend) ausgedruckt werden sollen.
  35.  
  36.   Hier eine Tabelle mit der maximalen Anzahl an Buchstaben pro Seite
  37.   für Bildschirm und Drucker (Einzelblatt- und Endlospapier):
  38.  
  39.   --------------------------------------------------------------------
  40.      Bildschirm    HighRes                            Text in Kbyte
  41.   --------------------------------------------------------------------
  42.   1. Normalmodus      22x80  Zeichen                   1.72        
  43.   2. Schmalmodus   2x 22x50  Zeichen                   2.15
  44.   --------------------------------------------------------------------
  45.      Drucker       11 Zoll           12 Zoll          Text in Kbyte
  46.   --------------------------------------------------------------------
  47.   1. Großmodus  :     58x72 Zeichen   64x72  Zeichen   4.08 / 4.50
  48.   2. Normalmodus:     58x80 Zeichen   64x80  Zeichen   4.53 / 5.00
  49.   3. Mediummodus:    112x80 Zeichen  125x80  Zeichen   8.75 / 9.77
  50.   4. Schmalmodus:  2x112x65 Zeichen                   14.22                
  51.   --------------------------------------------------------------------
  52.  
  53.  
  54. Das Programm MINILIST enstand aus dem Wunsch, ein Tool zu haben, das es ge-
  55. stattet, möglichst schnell Textdateien auf dem Bildschirm anzuzeigen.
  56. Das ATARI Betriebssystem erlaubt zwar das Anzeigen von Dateien aus dem
  57. Desktop heraus, jedoch ist lediglich ein vorwärts blättern möglich und es
  58. wird bei jeder neuen Seite nachgeladen, was durchaus lästig sein kann.
  59. Es sollte ein Programm enstehen, das ohne große 'Mausklickerei' erlaubt,
  60. Texte anzusehen und darin seitenweise vor- und zurückzublättern. 
  61. Später kamen dann auch die Ausgabe auf dem Drucker sowie weitere Bedien-
  62. funktionen hinzu. Um dem Program den internationalen Weg offenzuhalten, sind
  63. alle im Programm auftretenden Texte in Englisch gehalten, was aber die Be-
  64. dienung von nichtenglischsprachigen Benutzern nicht stören wird, da alle
  65. Funktionen an dieser Stelle in deutscher Sprache erklärt werden.
  66. Soweit zur Geschichte von MINILIST.
  67.  
  68. Der Name kam eigentlich von der ursprünglich geringen Größe des Programms
  69. Später bekam die Vorsilbe MINI dann eine wesentlich größere Bedeutung.
  70. Es enstand die Idee, Texte nicht nur in normaler Größe auf dem
  71. Bildschirm und Drucker auszugeben, sondern auch in einer wesentlich kom-
  72. primierten Darstellung um einerseits eine bessere Übersicht zu bekommen und
  73. andererseits Papier zu sparen. Die Schmalschrift auf dem Bildschirm er-
  74. folgt in der Zeichengröße der Iconbeschriftungen des Desktop, die Ausgabe
  75. auf dem Drucker wird mit den Attributen komprimiert, Elite, Superscript, und
  76. kleinerer Zeilenabstand kombiniert. Die komprimierteste Darstellung erfolgt 
  77. zweispaltig. Beim Ausdruck auf dem Drucker wird zunächst die linke Spalte be-
  78. druckt. Nachdem Sie das Papier nocheinmal eingezogen haben, wird automatisch
  79. die rechte Spalte bedruckt. 
  80.  
  81. In der normalen Zeichendarstellung (Normalmodus) werden auf dem Drucker 80
  82. Spalten gedruckt, in der komprimiertesten Darstellung nur 65 Spalten. Besteht
  83. nun ein Text aus Zeilen, die länger sind als die maximale Spaltenzahl erlaubt,
  84. dann werden die Zeilen einfach abgeknickt. Da MINILIST keine Neuformatierung
  85. des Textes auf die veränderten Spaltenzahlen beim Ausdruck vornimmt
  86. (MINILIST ist kein Textverarbeitungsprogramm, es gibt aber genügend), ent-
  87. stehen bei zu langen Zeilen unbeabsichtigte Lücken, zum Teil Leerzeilen.
  88. Zum Beispiel entsteht aus einer 70 Zeichen langen Textzeile im Schmalschrift-
  89. modus eine 65 Zeichen lange Zeile und eine 5 Zeichen lange Zeile, da die
  90. komplette ursprüngliche Zeile am Ende ein Linefeed enthält. 
  91.  
  92. Für einen optimalen Ausdruck mit möglichst wenig Lücken sollte daher die
  93. maximale Splatenzahl größer als die maximale Zeilenlänge des jeweiligen
  94. Textes sein, der Normalmodus mit 80 Spalten (Eliteschrift) und unkompri-
  95. mierter Zeichenhöhe eignet für alle Textdateien besonders gut, da hier die
  96. komplette Bildschirmbreite auf eine Papierseite original abgebildet werden
  97. kann.
  98.  
  99. Im sogenannten Mediummodus verdoppelt sich etwa die Anzahl der Zeilen pro
  100. Papierseite, da hier in Superscript gedruckt wird.
  101.  
  102. Der Schmalmodus eignet sich besonders, wenn relativ eng geschriebene Texte,
  103. wie Quellcode, ausgedruckt werden müssen. Die Textmenge beträgt hier 14.22!
  104. Kbyte pro Seite. In diesem Modus wird kein Rand gelassen.
  105.  
  106. Den Großmodus sollte man für Texte benutzen, die weniger als 72 Zeichen pro
  107. Zeile enthalten und besonders groß (lesbar) gedruckt werden sollen.
  108.  
  109. Die vorliegende Anleitung kann am besten im Normalmodus ausgedruckt werden,
  110. da sie mehr als 72 Spalten besitzt.
  111.  
  112. Bei den Darstellungsarten Groß, Normal und Medium hat das bedruckte Papier
  113. am linken Rand genügend Platz, so daß die Seite gelocht und abgeheftet wer-
  114. den kann. Bei der 2-spaltigen Darstellung kann keine Lochung vorgenommen
  115. werden.
  116.  
  117. MINILIST verfügt sowohl über die Möglichkeit Normalpapier (Einzelblätter,
  118. 11 Zoll) als auch über die Eigenschaft Endlospapier (12 Zoll) zu bedrucken. 
  119. Falls Sie Endlospapier benutzen, ziehen Sie bitte das Papier zu Anfang
  120. genau hinter die Perforation. MINILIST bedruckt die Seiten dann so, daß
  121. automatisch am Anfang jeder Papierseite zu drucken begonnen wird.
  122. Die Länge des bedruckten Bereichs beträgt aber weiterhin 11 Zoll, so daß
  123. Sie die restlichen 1 Zoll nach dem Druckvorgang abschneiden können und 
  124. die Seiten passend in einen DIN A4 Ordner einheften können.
  125.  
  126. Die Druckersteuerzeichen für die entsprechenden Attribute sind in
  127. der Datei MINILIST.CFG definiert und können durch das Ändern der Zahlen-
  128. kolonnen an andere Drucker angepaßt werden. Die Voreinstellung ist auf
  129. einen CITIZEN 120D Drucker ausgerichtet, müßte aber auf fast allen Epson-
  130. und IBM kompatiblen Druckern ohne große Änderungen funktionieren.
  131. Fügen Sie bitte die den in der jeweils darüberliegenden Zeile aufgeführten
  132. Attributen zugeordneten Steuercodes durch Kommas getrennt ein und beenden
  133. Sie die Zeile durch ein Semikolon. Jede Zahl muß dreistellig eingetragen
  134. werden, also notfalls mit führenden Nullen. Hier nun die genaue Erklärung 
  135. der 6 Zahlenkolonnen.
  136.  
  137.  
  138. 1.Reihe:  Druckercodes für die Großschrift ( 72 Spalten )
  139.           Reset, linker Rand in Spalte 6, rechter Rand in Spalte 77    
  140.  
  141. 2.Reihe:  Druckercodes für die Schmalschrift ( 2x65 Spalten )
  142.           Subscript, Compressed, Elite, Zeilenabstand 10/144 Zoll, 
  143.           linker Rand in Spalte 1, rechter Rand in Spalte 65
  144.  
  145. 3.Reihe:  Druckercodes für die linke Spalte bei Schmalschrift
  146.           Linker Rand in Spalte 1, rechter Rand in Spalte 65
  147.  
  148. 4.Reihe:  Druckercodes für die rechte Spalte bei Schmalschrift
  149.           Linker Rand in Spalte 70, rechter Rand in Spalte 134
  150.  
  151. 5.Reihe:  Druckercodes für Mediumschrift ( 80 Spalten )
  152.           Reset, linker Rand in Spalte 9, rechter Rand in Spalte 88,
  153.           Subscript, Zeilenabstand 10/144 Zoll, Elite
  154.  
  155. 6.Reihe:  Druckercodes für Normalschrift (80 Spalten )
  156.           Reset, linker Rand in Spalte 9, rechter Rand in Spalte 88,
  157.           Elite                      
  158.  
  159.  
  160. Ab Version 3.0 ist nun auch die Möglichkeit geboten, verschiedenen Atari-
  161. zeichen bestimmte Druckerzeichen zuzuordnen. Diese Möglichkeit wird bei-
  162. spielsweise benötigt, um bei manchen Druckern die deutschen Umlaute dem
  163. Atarizeichensatz anzupassen. Bei meinem CITIZEN Drucker lag das ß an einer
  164. anderen Stelle als beim Atarizeichensatz. Mit dieser Funktion ist es auch
  165. möglich, bei bestimmten Textformaten die Steuerzeichen durch Blanks aus-
  166. zublenden. Zur Definition schreiben Sie bitte, unter die Druckercodes für 
  167. die verschiedenen Schriftgrößen, jeweils eine Kommentarzeile und darunter 
  168. zuerst den Atarizeichensatz- Dezimalcode gefolgt von Komma und dem Drucker
  169. zeichensatz- Dezimalcode (siehe ß Umwandlung in der CFG-Datei).
  170. Momentan sind maximal 30 Zeichenumwandlungen zugelassen. Weitere Defini-
  171. tionen werden ignoriert.
  172.  
  173. Nun zu den Funktionen und Tastenbelegungen des Programms:
  174. ---------------------------------------------------------
  175.  
  176. - Help bringt Sie in ein Hilfsmenu, das alle Funktionen erläutert 
  177.   (Undo beendet die Hilfsfunktion)
  178.  
  179. - Mit den Cursortasten blättern Sie seitenweise vor- und zurück.
  180.  
  181. - Mit Taste E gelangt man zur letzten Seite des Textes.
  182.  
  183. - Taste G dient zur Auswahl einer bestimmten Seite indem der Benutzer
  184.   die entsprechende Seitennummer eingibt. Ist die eingegebene Nummer
  185.   größer als die letzte Seitennummer, so wird die letzte Seite gezeigt,
  186.   falls Zahlen kleiner 1 eingegeben werden wird Seite 1 angezeigt.
  187.  
  188. - Mit den Tasten 1,2 auf dem Zahlenblock wählen Sie 1 oder 2-spaltigen 
  189.   Text auf dem Bildschirm ( es wird zu Beginn einer neuen Schriftgröße
  190.   immer ab Seite 1 gelistet, da MINILIST die Seiten vom Anfang an berech-
  191.   net).
  192.  
  193. - Taste S zeigt eine Dialogbox, in die ein beliebiger String eingegeben
  194.   werden kann, nach dem gesucht werden soll. Das Programm sucht immer ab
  195.   der nächsten Seite bis zum Ende des Textes. Wird der String gefunden,
  196.   blättert MINILIST die entsprechende Seite auf, andernfalls wird eine
  197.   Meldung ausgegeben, das der String nicht gefunden wurde.
  198.  
  199. - Taste N sucht den zuletzt eingegebenen Suchbegriff erneut.
  200.  
  201. - Taste I zeigt eine Info Box, die die Gesamtanzahl der Zeilen des Text-
  202.   dokuments, die Anzahl Buchstaben der längsten Zeile, sowie die benötigte
  203.   Anzahl von Seiten für den Ausdruck in allen 4 Schriftgrößen enthält.
  204.   Dabei hängt die benötigte Seitenzahl natürlich von der momentan gewählten
  205.   Papierlänge ab ( Einzelblatt- oder Endlospapier ).
  206.  
  207. - Mit F1 - F4  wird in kleiner, mittlerer, normaler, bzw. grosser Schrift 
  208.   auf dem Drucker ausgegeben.
  209.   Entweder wird der ganze Text ausgedruckt oder nur die aktuelle sicht-
  210.   bare Information (es erscheint eine Alert-Box, All=Alles, Part=Teil).
  211.  
  212. - Die Taste P dient zum Einstellen der Papierlänge (11- oder 12 Zoll).
  213.  
  214. - L sorgt für ein Linefeed auf dem Drucker
  215.  
  216. - F sorgt für ein Formfeed auf dem Drucker
  217.  
  218. - Taste R dient wie Q zum Verlassen des Programms, es wird aber außerdem bei
  219.   der Accessory- Version der akuelle Zustand des Programms eingefroren, d.h.
  220.   es ist möglich MINILIST für bestimmte Zeit zu verlassen, ohne das der im
  221.   Speicher befindliche Text gelöscht wird. Wird nun MINILIST ein weiteres
  222.   Mal aufgerufen, so meldet sich das Programm mit gleichen Attributen
  223.   ( Textdatei, Schriftgröße, Seitennummer, Papierlänge für den Drucker )
  224.   wieder. Diese Funktion ist zum Beispiel für diejenigen gedacht, die wich-
  225.   tige Textinformationen ( Tastaturbelegungen, Übersetzungen ) für längere
  226.   Zeit immer griffbereit haben möchten, dies ist natürlich nur möglich wenn
  227.   das entsprechende Programm, mit dem gearbeitet wird, Accessories zuläßt.
  228.   Diese sogenannte Klemmbrettfunktion erlaubt also residente Textdateien und
  229.   ist seit Version 2.7 enthalten.
  230.  
  231. - Mit Q wird MINILIST beendet
  232.  
  233.  
  234. In der untersten Zeile auf dem Bildschirm erscheinen Name des Textdokumentes,
  235. die Papierlänge für den Drucker in Zoll, aktuelle Seitennummer, prozentuale 
  236. Position innerhalb des Gesamttextes, Länge des Textfiles in Bytes, Datum und
  237. Uhrzeit, sowie die Anzahl freier Bytes.
  238.  
  239. Beim Ausdruck erscheinen auf jeder ausgedruckten Seite  Filename und Seiten-
  240. nummer.
  241.  
  242.  
  243. Hier die gesamte Tastaturbelegung nochmals in graphischer Übersicht, so wie
  244. man auf die Tastatur des Atari schaut:
  245.  
  246. -----------------------------------------------------------------------------
  247. F1 Schmaldruck  F2 Mediumdruck  F3 Normaldruck  F4 Großdruck
  248.                                                         Help  Hilfsmenu      
  249. q Beenden  e Textende  r resident  i Info  p Papierlänge  Up  rückwärts 
  250.  s Suchen  f Form feed  g Seite  l Line feed             Down vorwärts  
  251.                             n weitersuchen            1  1-seitig 2  2-seitig  
  252. ----------------------------------------------------------------------------- 
  253.  
  254.  
  255. Hier noch kurz die Änderungen der Version 3.6 gegenüber der Version 3.0:
  256.  
  257. - verbesserte Suchfunktion ( Taste N sucht letzten Begriff nochmals )
  258. - Info Box ( Taste I )
  259. - Ausgabe der momentan an den Drucker zu sendenden Seitennummer
  260. - Anzeigen von aktueller Papierlänge, Datum, Uhrzeit und Anzahl freier Bytes
  261. - aktuelle Papierlänge wird nach Laden einer neuen Textdatei nicht mehr auf
  262.   11'' zurückgesetzt, sondern behält ihren Wert bis der Benutzer diese ändert
  263. - Ausgewählte Pfade in der Fileselektorbox bleiben nun erhalten
  264. - einige sonstige kleine Verbesserungen
  265.  
  266.  
  267. Falls Sie Verbesserungsvorschläge oder Anregungen haben, dann schreiben
  268. Sie bitte an folgende Adresse:
  269.  
  270.                             Thomas Broich
  271.                             Lehnsgrund 28
  272.                             4300 Essen 1
  273.                             Tel. 0201 - 713614
  274.  
  275. oder honorieren die mühsame und zeitaufwendige Programmierarbeit mit einer
  276. Spende von 20.- DM (dann bekommt man den Sourcecode, ca. 35 Kbyte, und falls
  277. vorhanden, eine neue Version zugeschickt ) an:
  278.  
  279.                             Sparkasse Essen
  280.                             BLZ 360 501 05
  281.                             Kontonummer 8841736
  282.  
  283. Das Programm läuft sowohl als Accessory als auch als PRG (einfach umbenennen).
  284.  
  285. Folgende Dateien gehören zum Programm MINILIST:
  286.  
  287. - MINILIST.ACC ( Programmodul )
  288. - MINILIST.CFG ( Datei mit speziellen Druckersteuercodes )
  289. - MINILIST.DOC ( deutsche Bedienungsanleitung )
  290. - MINILIST.RSC ( Resourcedatei für die Dialogboxen )
  291.  
  292. Der Sourcecode enthält zusätzlich noch die folgenden Dateien:
  293.  
  294. - MINILIST.C   ( C Source Code )
  295. - MINILIST.DEF ( Definition der Resourcedatei )
  296. - MINILIST.H   ( Headerdatei mit Objektdefinitionen )
  297.  
  298. ______________________________________________________________________________
  299.  
  300.